home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Internet Tools 1995 April / Internet Tools.iso / infoserv / gopher / Unix / GopherTools / glog / glog34.readme < prev    next >
Encoding:
Text File  |  1994-04-07  |  4.0 KB  |  112 lines
  1.                           Gopher Log Analyzer 3.4
  2.                      Andy Wick
  3.               awick@csugrad.cs.vt.edu
  4.  
  5. What is it:
  6.    glog will allow you to analyze your gopher log files.  Hopefully
  7. supplying you will useful reports/plots/histograms.  It is very easy
  8. to use, and compile.  It should compile with any standard ansi compiler,  
  9. and now it should even work under VMS. (thanks Dennis R. Sherman)
  10.  
  11. To compile: (assuming gcc)
  12.    gcc glog34.c -o glog
  13.  
  14. How to use:
  15.  glog -h will display the options :).  But as a short example.  
  16.  
  17.  To create a [H]ost report, a [D]ata report with detail of [H]osts and
  18.  width of 132, a plot of [T]ypes with basename of "test", and finally
  19.  a histogram of t[I]mes.  The log file is called gopher.log.  Don't forget, 
  20.  reports always go to stdout, unless the -o options is used.
  21.  
  22.  % glog -rH -w 132 -rDH -f test -pT -gI < gopher.log | more
  23.  
  24. Tested on:
  25.  Amiga DOS, SunOS 4.1.3 (purify 2.0.3), Ultrix 4.2A
  26.  gcc 2.3.3 and higher was used on all platforms.
  27.  
  28. Features:
  29.  * The command line is parsed as the reports/plots/histograms are generated, 
  30.    so that it is possible to change options for each separately.  But options
  31.    are NOT reset for each new one.
  32.  
  33.  * Produces reports/plots/histograms on the [D]ata, [H]osts, day of the [W]eek,
  34.    data [T]ypes, T[I]me, and [M]onth/date sorted (ie. sorted by date).
  35.  
  36.  * Produces detailed reports on any thing you can produce a normal
  37.    report for.  Yes, you can even produce a host detail report of a 
  38.    hosts report. (But it doesn't do you much good :)
  39.  
  40.  * Change the width of the reports.
  41.  
  42.  * You can specify the filename for plots, it defaults to gopher. (The 
  43.    program appends a .dat, and and .run to the name)
  44.  
  45.  * You can request as many plots as you want. (But remember to change the
  46.    filename or you will overwrite the last plot)
  47.    
  48.  * The program is now a lot easier to add new types of reports to, you
  49.    only need to add 3 short routines, a variable, and edit 2 functions.
  50.    (Well, maybe it is simple for me. :)
  51.  
  52.  * Can select starting and ending month. (Sorry no wrap around)
  53.  
  54.  * Average/Estimating can be done with the -aX option.  Possible values
  55.    for "X" are [E]verything (default), [Y]ear, [M]onth, [W]eek, [D]ay, and [H]our
  56.  
  57. Where to get:
  58. - boombox
  59. - On the csugrad.cs.vt.edu gopher server (port 70) in
  60.     "Software/Gopher Log Analyzer"
  61.  
  62. Changes:
  63. 3.4  4/4/94
  64.    bug fixes and enhancements: 
  65.       Andy Wick - awick@csugrad.cs.vt.edu
  66.       John-David Childs - jdc@selway.umt.edu
  67.       Dennis R. Sherman - dennis_sherman@unc.edu
  68.  
  69.    * improved coding efficiency in ProcessLine()
  70.    * fixed bug when identifying FTP type to include ftp-vms: and
  71.         ftp-nopasv: strings used by the NOPASV patch
  72.    * allows DEFINING whether you want to output the text users searchs for
  73.    * works under VMS
  74.    * added histogram support
  75.    * added averaging/estimating support
  76.    * added input/output files options
  77.    * fixed up this file and comments
  78.  
  79. 3.3  7/20/93
  80.    bug fixes:  John-David Childs - jdc@selway.umt.edu
  81.  
  82.    * Fixed up main() routine so that: errors on the command line (or -h
  83.    as the first parameter) cause glog to print the help information and
  84.    abort.
  85.    * Fixed PrintHelp() routine so help message is more understandable.
  86.    * changed FILETYPE character from ' ' to 'I' (What about Image?)
  87.    
  88. 3.2 7/19/93
  89.    Andy Wick - awick@csugrad.cs.vt.edu
  90.    Slight bug in ProcessLine dealing with searches fixed.
  91.  
  92. 3.1 7/17/93
  93.    Andy Wick - awick@csugrad.cs.vt.edu
  94.    adds some features of the old glog that were removed by mistake.
  95.    * Supports all known log entries now. (I was missing search, binary,
  96.       and someothers)
  97.    * Can now have a tIme report
  98.    * The report presentation is a little better
  99.    * Can specify a starting and ending month for the whole command
  100.    with -s <num> and -e <num>.  These are the only options that
  101.    are used for the WHOLE command.  The rest are from left
  102.    to right.
  103.  
  104. TODO:
  105.  * Fix up plots some more
  106.  * Make some documentation
  107.  * Improve error checking
  108.  * Allow wrap around starting/stoping months.
  109.  
  110. If anyone has any ideas or suggestions please send them to me.
  111.  
  112.